Vertex Troubleshooting

Purpose: Troubleshooting information includes:

Processing Errors

Tax Calculation Rules

Processing Errors

Troubleshooting for the integration between Order Management System and Vertex begins with checking the TRACE.log and CWDirect.log files.

• The TRACE.log file is typically located under /domain/conf/OMSFiles/Logs/TRACE/ on your application server, where domain is the WebLogic domain directory for Order Management System.

• The CWDirect.log file is typically located under /domain/log/CWDirect.log on your application server, where domain is the WebLogic domain directory for Order Management System.

Error in TRACE.log File

Explanation

How to Correct:

Initial Configuration Issues

ERROR TRACE - Class not found:

ERROR TRACE - TAX_INT web service error: - null

A required class was not installed during the initial installation process.

Contact your Order Management System representative.

ERROR TRACE - AxisFault exception in invoke method of com.cwi.direct.interfaces.webservice.VertexWS: exception on AXIS invoke: User login failed: invalid_user.

; nested exception is:

User login failed: invalid_user.

Possible causes:

• An incorrect user ID and password were entered as the UserName and Password in the Vertex User ID and Password, or

• The user ID specified in the Vertex User ID and Password was not created correctly in Vertex.

Check the contents of the Vertex User ID and Password and confirm that the user ID and password exist in Vertex and have authority to the correct partition in Vertex. See Set up Data within Vertex and your Vertex documentation for more information.

After you change the user ID and password in the Vertex User ID and Password, you need to stop and restart Order Management System. See Restarting Order Management System for more information.

ERROR TRACE - AxisFault exception in invoke method of com.cwi.direct.interfaces.webservice.VertexWS: exception on AXIS invoke: SAX processing failed on input stream

SAX processing failed when attempting to create new element. (parent element=com.vertexinc.tps.xml.calc.parsegenerate.builder.ParticipantData, new element=null, local element name=PhysicalOrigin

No physical origin is being passed. The physical origin is the address of the warehouse for the order detail line. Possible causes:

• The Default Values by Company XML File was not set up correctly

• Warehouse list setup in Order Management System is not correct

Default Values by Company XML File: Confirm that the file exists for the company, contains valid data, and is in valid XML format.

• See Working with Warehouse Lists (WWHL) for information on setting up warehouse lists in Order Management System.

AxisFault exception in invoke method of com.cwi.direct.interfaces.webservice.VertexWS: exception on AXIS invoke: SAX processing failed on input stream

Non-fatal error detected during SAX parsing. Verify document against schema or contact document supplier. (URI=null, line number=30, error=cvc-datatype-valid.1.2.1: '' is not a valid value for 'integer'.)

The Default Warehouse (A04) is not listed in the Warehouses XML File.

Warehouses XML File: Confirm that the Default Warehouse (A04) is included in this file.

Tax Calculation Failing After Initial Setup

ERROR TRACE - AxisFault exception in invoke method of com.cwi.direct.interfaces.webservice.VertexWS: exception on AXIS invoke: ; nested exception is:

java.net.ConnectException: Connection refused: connect; nested exception is:

java.net.ConnectException: Connection refused: connect

Order Management System can no longer reach Vertex.

Contact your Order Management System representative.

ERROR TRACE - AxisFault exception in invoke method of com.cwi.direct.interfaces.webservice.VertexWS: exception on AXIS invoke: An error occured during CalcEngine.calculateTax. This may be an incorrect use of the calculation engine. Please contact your software vendor.

Error trying to calculate tax.

Cannot find tax areas. Please verify that the address or tax area id provided for the location is correct and retry.

The postal code passed in the tax request message from Order Management System is incorrect, or is associated with a city that does not exist in Vertex. To confirm, log onto Vertex and advance to the Tax Area Lookup Tool, then search for the shipping address that is causing the error. A message such as the following indicates that the postal code is incorrect:

No tax areas were found during the lookup. The address fields are inconsistent for the specified asOfDate. (Street Information=24 PRIME PKWY, Postal Code=01701, City=NATICK, Sub Division=null, Main Division=MA, Country=USA, As Of Date=20060627)

Correct the postal code information in Order Management System.

ERROR TRACE - AxisFault exception in invoke method of com.cwi.direct.interfaces.webservice.VertexWS: exception on AXIS invoke: ; nested exception is:

java.net.SocketException: No buffer space available (maximum connections reached?): connect

The Order Management System server is out of memory.

Reboot the Order Management System server.

ERROR TRACE - AxisFault exception in invoke method of com.cwi.direct.interfaces.webservice.VertexWS: exception on AXIS invoke: (404)Not Found; nested exception is:

(404)Not Found

The URL specified for Vertex in the Vertex URL property is incorrect.

1. Correct the URL in the Vertex URL property.

2. Stop and restart Order Management System.

See Restarting Order Management System for more information.

Miscellaneous Log Messages

WARN TRACE - WARNING:Responses for DISTRIBUTE not found in configuration xml.

The log includes this message when Order Management System requests tax information for an order that includes a tax override.

No need to correct; message is informational only.

Tax Calculation Rules

Situation

Explanation

New settings in Vertex apply when you use the Vertex Transaction Tester, but not when Order Management System requests tax information

If you have Vertex configured to cache information for improved performance, it might be retrieving tax rules from cached information when Order Management System requests tax information. Caching does not apply when you use the Transaction Tester. Consult your Vertex documentation for more information on configuring caching.

An item on an order is not taxable based on its item or product class settings in Vertex, or on the Tax override flag for the order line; but there is still tax on the order

Even if an item on an order is not taxable, freight, handling, gift wrap, additional freight, and duty can still be subject to tax.

You receive an order that includes an item with a tax override through the generic order interface, but the order line is still taxed

Even if the tax_override flag is set to Y in the inbound order message, Order Management System does not apply a tax override unless the inbound order message also specifies a tax amount greater than zero for the order line.

You make a change to the Vertex wsdl (Web Service Definition Language) File, but the changes do not take effect

Before your changes take effect, you need to restart Order Management System. See Restarting Order Management System for more information.

You change the user ID and password in the Vertex User ID and Password, but the changes do not take effect

Before your changes take effect, you need to restart Order Management System. See Restarting Order Management System for more information.

Vertex troubleshooting OMS 17.1 September 2018 OTN